home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Developers / p2c / p2c 1.21a2.1 / p2c 1.21a2.1.rsrc / TEXT_135_Line Breaking.txt < prev    next >
Encoding:
Text File  |  1994-11-22  |  5.0 KB  |  158 lines
  1. # LINE BREAKING
  2.  
  3. LineWidth    # Target max output line width; default=78.
  4.  
  5. MaxLineWidth    # Absolute max output line width; default=90.
  6.  
  7. OverWidePenalty # Penalty for line lengths > LineWidth.
  8.     # Default=25.    (Penalties are real numbers.)
  9.  
  10. OverWideExtraPenalty    # Additional penalty multiplied by
  11.     # number-of-chars-too-long squared.
  12.     # Default=1.    Total over-wide penalty is
  13.     #    OW = max(OWP + N^2*OWEP, 0).
  14.  
  15. EarlyBreakPenalty    # Penalty for breaking at early break-points
  16.     # among those at a given nesting level.
  17.     # Default=1.    If N=number of possible break
  18.     # points before this one in this nesting,
  19.     #    EB = -N*EBP.
  20.  
  21. CommaBreakPenalty    # Penalty for breaking lines after a comma.
  22.     # Default=10.
  23.  
  24. CommaBreakExtraPenalty    # Additional penalty multiplied by nesting
  25.     # level of (number of parens enclosing) comma.
  26.     # Default=5.    Total comma-break penalty is
  27.     #    B = max(P + CBP + N*CBEP, 1.0)
  28.     # where
  29.     #    P = OW + EB + SIP + IP    (defined elsewhere)
  30.  
  31. SpecialArgBreakPenalty    # Penalty for breaking lines after a comma
  32.     # which follows a "special" argument, such
  33.     # as the format string of a printf. Default=5.
  34.  
  35. OpBreakPenalty    # Penalty for breaking at an operator (like +).
  36.     # Analogous to CommaBreakPenalty; default=25.
  37.  
  38. OpBreakExtraPenalty # Additional penalty multiplied by nesting
  39.     # level of the operator.    Default=20.
  40.  
  41. LogBreakPenalty # Penalty for breaking at an && or || operator.
  42.     # Default=5.
  43.  
  44. LogBreakExtraPenalty    # Additional penalty multiplied by nesting
  45.     # level of the logical operator.    Default=1.
  46.  
  47. RelBreakPenalty # Penalty for breaking at a relational
  48.     # operator. Default=20.
  49.  
  50. RelBreakExtraPenalty    # Additional penalty multiplied by nesting
  51.     # level of the relational op.    Default=10.
  52.  
  53. ExHyphenPenalty # Additional penalty for breaking a line just
  54.     # after a minus sign.    Default=10. :-)
  55.  
  56. AssignBreakPenalty    # Penalty for breaking at an assignment
  57.     # operator. Default=50.
  58.  
  59. AssignBreakExtraPenalty # Additional penalty multiplied by nesting
  60.     # level of the assignment.    Default=30.
  61.  
  62. QMarkBreakPenalty    # Penalty for breaking lines at the "?" of
  63.     # a "?:" operator.    Default=50. (Colons
  64.     # get the regular OpBreakPenalty.)
  65.  
  66. QMarkBreakExtraPenalty    # Additional penalty multiplied by nesting
  67.     # level of the "?:" operator.    Default=30.
  68.  
  69. ParenBreakPenalty    # Penalty for breaking after an open paren
  70.     # in a function call:
  71.     #    long_function_name(
  72.     #    very_long_argument);
  73.     # Default=25.
  74.  
  75. ParenBreakExtraPenalty    # Additional penalty multiplied by nesting
  76.     # level of the parentheses. Default=10.
  77.  
  78. MoreBreakPenalty    # Adjustment to CommaBreakPenalty, etc.,
  79.     # if it is the second or later break in the
  80.     # same nesting. (E.g., if two or more commas
  81.     # of a function call are broken.)    Default=-5.
  82.  
  83. MoreBreakExtraPenalty    # Adjustment to CommaBreakExtraPenalty, etc.,
  84.     # as in MoreBreakPenalty.    Default=-3.
  85.  
  86. WrongSidePenalty    # Extra penalty for breaking on the less
  87.     # preferred side of an operator (see BreakArith
  88.     # et al below). Default=10.
  89.  
  90. ExtraIndentPenalty    # Penalty for indenting by ExtraIndent instead
  91.     # of according to nesting order.    If negative,
  92.     # -EIP is penalty for *not* using ExtraIndent.
  93.     # Default=30.
  94.  
  95. BumpIndentPenalty    # Penalty for using BumpIndent for identation.
  96.     # Default=10.
  97.  
  98. NoBumpIndentPenalty # Penalty for not using BumpIndent when it
  99.     # ought to have been used.    Default=25.
  100.  
  101. IndentAmountPenalty # Penalty for indentation; for a line indented
  102.     # N spaces (beyond the indentation of the
  103.     # statement as a whole),
  104.     #    IP = N*IAP.
  105.     # Default=0.5.
  106.  
  107. SameIndentPenalty    # Penalty for indenting two successive lines
  108.     # the same even though they belong to different
  109.     # nesting levels:
  110.     #    foo = x +
  111.     #    y *
  112.     #    z
  113.     # Default=5.
  114.  
  115. MaxLineBreakTries    # Limit to the number of line breaking
  116.     # alternatives to be tried. Default=5000.
  117.  
  118. AllOrNoneBreak    # List of functions for which arguments must
  119. AllOrNoneBreak    # be written all on one line or all on separate
  120. AllOrNoneBreak    # lines.    (A given function may have only one
  121. AllOrNoneBreak    # of this and the following break properties.)
  122.  
  123. OneSpecialArg    printf    # List of functions like printf for which the
  124. OneSpecialArg    # first argument is "special", remaining args
  125. OneSpecialArg    # are uniform.
  126.  
  127. TwoSpecialArgs    sprintf # List of functions like fprintf for which the
  128. TwoSpecialArgs    fprintf # first two arguments are "special".
  129.  
  130. ThreeSpecialArgs    # List of functions for which the first three
  131. ThreeSpecialArgs    # arguments are "special".
  132.  
  133. BreakArith    # Options string for how to break lines at
  134.     # arithmetic operators. One or more of:
  135.     #    L    Break on left side of operator.
  136.     #    R    Break on right side of operator.
  137.     #    H    Same as L, but use "hanging" indent.
  138.     #    N    No breaking.
  139.     #    L>R Break either way, L preferred (or R<L).
  140.     #    R>L Break either way, R preferred (or L<R).
  141.     #    L=R Break either way equally (or LR).
  142.     #    A    (with above) Use all-or-none breaking.
  143.     # Default is R.
  144.  
  145. BreakRel    # Same for relational ops (==, <, etc.)
  146.  
  147. BreakLog    # Same for logical operators && and ||
  148.  
  149. BreakDot    # Same for dot operators . and ->
  150.  
  151. BreakAssign # Same for assignments.
  152.  
  153. For_AllOrNone    # 1 or default=all-or-none breaking of the
  154.     # three clauses of a "for" statement.    0=plain.
  155.  
  156.  
  157.  
  158.